home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / comm / cmodem44.zip / RCMODEM.DOC < prev    next >
Text File  |  1990-09-24  |  10KB  |  345 lines
  1. ------------------------------------------------------------------------------
  2.  
  3.                            C C H L L - M O D E M
  4.                                 rC-MODEM v4.40
  5.  
  6. ------------------------------------------------------------------------------
  7.             Hanns Ludwig Lippmann Cultural Center (CCHLL) 1989,1990
  8.             
  9.                      Lavio Pareschi - all rights reserved
  10.  
  11.   As a shareware program, this is not to be to sold or held. DISTRIBUTE IT !
  12.  
  13. ------------------------------------------------------------------------------
  14.  
  15. QUICK START
  16. ----- -----
  17. rcmodem
  18. -it will ask you a few questions
  19.  
  20. rcmodem /p=1/rx
  21. -com1 port, receive a file at current subdir
  22.  
  23. rcmodem /p=1/tx c:\path\filename
  24. -com1 port, transmit filename
  25.  
  26. rcmodem /p=2/s=q/tsr
  27. -com2 port, size of block = quick, stay resident
  28.  
  29. rcmodem /p=1/tx
  30. -com1 port, transmit automatic to CSBbs (no need local name)
  31. -------------------------------------------------------------------------------
  32.  FEATURES
  33.  --------
  34.  
  35. >> MAJOR Features of this Ibm-PC communications asynchronous protocol :
  36.  
  37. . crash recovery
  38. . speed!
  39. . optimum block size math calculated
  40. . easy multiple files specification
  41.  
  42. 1 - Transmission CRASH Recovery
  43.  
  44. If interrupted by any factor, the file transmitted is saved with the
  45. extension file.BAD until the last byte is received correctly.
  46. In the next connection/transmission, the file will be completed automatically.
  47.  
  48.  
  49. 2 - VARIABLE DATA : data blocks of optimum variable size, calculated.
  50.  
  51. Depending on the speed and errors during transmission, as well as line 
  52. noise, the size of the data-blocks between crc-blocks will vary between
  53. 32 to 4096 bytes.
  54. This reduces the amount of control bytes added to the transmission and
  55. minimizes data repetition.
  56. The result is an excellent, true transfer rate.
  57.  
  58.  
  59. 3 - FULL duplex
  60.  
  61. The transmitter side does not stop on every block to receive useless answers.
  62. The transmission occurs without pauses between blocks.
  63. The receiver only warns when something goes wrong.
  64.  
  65.  
  66. 4 - ERRORS/BYTE/CALLS
  67.  
  68. Starts the data blocks size with the expected value.
  69. Uses statistical calculations to find the optimum block size based on time,
  70. errors, and calls accumulated numbers.
  71.  
  72.  
  73. 5 - RESIDENT, if wanted
  74.  
  75. It can stay resident and called up by:
  76. ctrl-up  : uploads
  77. ctrl-down: downloads
  78. ctrl-ins : change parameters
  79.  
  80.  
  81. 6 - MULTIPLE FILES
  82.  
  83. 1. Only need to edit the file "tx_file.txt" with the filenames and use the
  84.    /multi switch
  85.  
  86. 2. Wildcards "/tx file*.*" allow multiple files selection
  87.  
  88. ------------------------------------------------------------------------------
  89.  
  90. FILES IN THIS PACKAGE: CMODEMxx.COM (Lharc self extract):
  91.  
  92. RCMODEM.EXE
  93. Executable file to be used as an external protocol (Msdos).
  94.  
  95. RCSETUP.EXE
  96. To set up and create "cmodem.cfg", a configuration file.
  97.  
  98. RCSTOP.EXE
  99. To send ctrl-Xs to stop transmitter at the other size.
  100.  
  101. RCMODEM.DOC
  102. This doc file.
  103.  
  104. RXPCPL.BAT
  105. Batch file for ProcomPlus (download).
  106.  
  107. TXPCPL.BAT
  108. Batch file for ProcomPlus (upload).
  109.  
  110. RX.BAT & TX.BAT
  111. Batch files for use via Dos, with any communications package that
  112. allows DOS access during connection and use of COM interrupt vectors.
  113.  
  114. RXBBS.BAT & TXBBS.BAT and others
  115. Batch file examples for use in BBSs.
  116.  
  117. SHARE.TXT
  118. Shareware concepts and registration.
  119.  
  120. EXAMPLES.DOC
  121. Quick command examples.
  122.  
  123. -------------------------------------------------------------------------------
  124.  
  125. COMMANDS
  126.  
  127. rC-Modem [switches] [filepathname]
  128.  
  129. Switches:
  130.  
  131. /p=i/rx/tx/b=n/off/bbs/n=i/pause/tsr/s=x/quit/d=i/log/bios/multi/old/l=i
  132. /dcd/cts
  133.               ^
  134.               |___  Note: NO spaces between switches
  135.  
  136.  
  137. /p=i : PORT 1(com1), 2(com2), 3 or 4. Default = 1.
  138.  
  139.  
  140. /rx : for downloads, default.
  141.  
  142. . it is not necessary to type the filename during downloads,
  143.   the transmitter will do the job.
  144.  
  145.  
  146. /tx : for uploads.
  147.       filepathname needed unless /csb is used
  148.  
  149.  
  150. /b : BAUD = 300, 1200, 2400, 4800 or 9600 or 0
  151.  
  152. . initializes the serial port with baud, parity, stop and word length.
  153. . if not specified, the existing configuration of the serial port will be
  154.   automatically detected and used 
  155. . if b=0, then no baud detection will be made, being unknown, and it will
  156.   use the remaining existing configuration of the serial port.
  157. . the goal of "b=0" is to disrrupt the auto baud detection, if this
  158.   is not correct, as it relies on hardware.
  159. . it may be possible to achieve better efficiency if this paramater is used
  160.   to pinpoint the correct baud rate in any case.
  161.  
  162.  
  163. /off : turns off the CRASH recovery function (it will OVERWRITE any file
  164.        that was not completely transmitted)
  165.  
  166.  
  167. /bbs : no vector ctrl-break, (default is to vector)
  168.        reports to CMODEM.LOG
  169.  
  170. . no change in ctrl-break and ctrl-C interrupt vectors.
  171. . no pause and alarm on return
  172.  
  173.  
  174. /n=i : NOISE expected (from 0=low to 10=high)
  175.        Default uses cmodem.dat (recommended)
  176.  
  177.  
  178. /pause : pause (20 secs) and alarm before return (default = no pause)
  179.  
  180.  
  181. /tsr : stay resident
  182.  
  183.  Hot keys:
  184.  ctrl-down: downloads
  185.  ctrl-up  : uploads
  186.  ctrl-ins : change parameters as "/param1/param2..."
  187.  
  188.  
  189. /quit : to remove the rcmodem from memory if /tsr was used
  190.  
  191.  
  192. /s=q or /s=c : determines the way to change size blocks
  193.  
  194. . q = quick.
  195. . c = calculate the optimum size, default.
  196.  
  197.  
  198. /d=i : internal delays extended  "i" seconds, range = {0,30}, default = 0
  199.        maybe useful in delayed phone lines
  200.  
  201.  
  202. /log : report to CMODEM.LOG
  203.        useful to log up/downs activities
  204.        bbs utility
  205.  
  206.  
  207. /bios : no direct video (default direct)
  208.  
  209.  
  210. /multi : use files edited in TX_FILES.TXT to transmit (see example file)
  211.  
  212.  
  213. /old : use with cmodem versions 1,2,3.x
  214.  
  215.        If not used, the default:
  216.        . automatic tx, the filepathname is not necessary
  217.        . the subdir used will be the current.
  218.        . must be used with CSBbs
  219.  
  220.  
  221. /l=i : disable circular msg when /l=0
  222.        default on
  223.  
  224.  
  225. /dcd : disable carrier checks
  226.        default enabled
  227.  
  228.  
  229. /cts : disable cts line check
  230.        default enabled
  231.  
  232.  
  233. filepathname = path and name of file to be transmitted
  234.  
  235. . necessary when specifying /tx (upload), unless /csb is used.
  236. . if present for /rx, then has priority over filename from transmitter.
  237. . wildcards allow multiple files
  238.  
  239.  
  240. COM PORTS:
  241.  
  242. Com1 : 3F8 - 3FF - IRQ4
  243. Com2 : 2F8 - 2FF - IRQ3
  244. Com3 : 3E8 - 3EF - IRQ4    (non standard)
  245. Com4 : 2E8 - 2EF - IRQ3    (non standard)
  246.  
  247. -------------------------------------------------------------------------------
  248. GUIDELINES:
  249.  
  250.  
  251. >>> PROCOMPLUS <<<
  252.  
  253. TXPCPL.BAT:
  254. rcmodem /tx/p=1 %1
  255.  
  256. - in setting up Procomm Plus (Tm DataStorm Technologies Inc.) you may use
  257.   txpcpl.bat as an external protocol.
  258. - starting an upload, ProcommPlus will ask you a filename to transmit,
  259.   which will be recognized by the parameter %1 used in the .bat file.
  260. - no filename is needed during the download
  261. - you may edit those .bat files to configure it correctly according to your
  262.   system.
  263.  
  264.  
  265. GTPOWER, QMODEM, ZCOMM, MIRROR, TELIX, TELEMATE and others.
  266.  
  267. - access the DOS shell
  268. - give the .bat command:
  269.   >  RX          (to download) or
  270.   >  TX filename (to upload)
  271.   this will execute the external protocol. 
  272.  
  273.  
  274. --- RESIDENT ---
  275.  
  276. Install using the /tsr switch, BEFORE you run your comunication software:
  277.  
  278. rcmodem /tsr/p=1 ... for example
  279.  
  280. Use the hot-keys, as explained, to upload, download and change parameters.
  281.  
  282.  
  283. --- BBSs ---
  284.  
  285. - returns error level 0 if transmission ends ok
  286. - returns error level 1 if transmission ends bad
  287.  
  288. - creates CMODEM.LOG (only if /bbs is selected).
  289.  
  290.  
  291. --- RECOVERY ---
  292.  
  293. Aborted transmissions give the file x the name x.BAD  <-- IMPORTANT
  294. So, no confusion is made.
  295.  
  296. If you want to recover a file aborted with another protocol, rename to file.BAD
  297. and try rC-Modem!
  298.  
  299. -------------------------------------------------------------------------------
  300.  
  301. CMODEM.DAT    (see switches /s=c and /s=q)
  302.  
  303. Statistical methods and some math give us an optimum size of the data blocks,
  304. to mimimize losses due to overheads on control blocks and repeated blocks
  305. because of noise.
  306. A file "